***************************

Credit:

***************************

Written by Anton Marini - 'vade' 
see http://002.vade.info

Many thanks to Maxx Rupp for his patient OpenGL advice, and #macdev for tolerating my incessant rants.

***************************

License:

***************************

Creative Commons, Attribution - Non Commercial - Share Alike 3.0

http://creativecommons.org/licenses/by-nc-sa/3.0/

The source code for the project is included. Do what you want, just dont re-package the code and sell it, please. I interpret the non commercial clause to apply *only to the code*, not to your creative uses of the plugin. So use it in performance, and get paid, just dont sell your altered code base, I'd be a sad pony. 

Disclaimer: If it wakes up in the middle of the night and kills your family, it is not my fault... really. In other words, use at your own risk.

***************************

Instructions:

***************************

	This plugin requires OS X 10.5.3 (At least, ive not tested it on earlier versions), and a copy of VDMX, or another Quartz Composer Composition 'host' app.

	Installation: The plugin goes in your "/Library/Graphics/Quartz Composer Plug-ins/" folder.

	In VDMX:
	1)	Drag the provided QTZ file to a Media Bin.
	2)	Select the QTZ and make sure it is part of a layer chain.
	3)	The QTZ controls are available in a 'Layer Control' module, as usual.

***************************

Controls:

***************************

	1)	The basic idea is that the QTZ/Plugin provide an image of your desktop. The image can be cropped to a portion of the main screen.
	2)	Origin X/Y controls where on your desktop the image, from the lower left corner of the image.
	3)	Width + height control how large the image is, and how large a portion of the desktop the plugin grabs. Pixels are 1 to 1.
	4)	To get your full desktop, origin @ 0,0, width and height set to max.

	Use the plugin to grab video from applications which provide some functionality VDMX/Quartz Composer may not, like:

	3L
	Flash
	Modul8
	Processing
	Mathematica
	Pure Data/GEM
	Max/MSP/Jitter
	<anything on the screen at all> 
	
	Have fun.

***************************

Known Issues: 

***************************

Screen garbage due to hitting edge of buffer. Its pretty. Use it.

IN CAPS, BECAUSE I KNOW: IF YOU LAUNCH THE QTZ FILE OR OPEN IT IN QUARTZ COMPOSER, IT CRASHES QUARTZ COMPOSER OR THROWS ERRORS. SPECULATION FOLLOWS:

AS FAR AS I KNOW, THIS IS AN APPLE RELATED ISSUE. THEY ARE USING PRIVATE APIS, OR SOME PRIVATE OPENGL PIXEL FORMAT WHICH MAKES SHARING BASICALLY IMPOSSIBLE TO THE NON SUPER HUMAN. 
FOR NOW, PLEASE IGNORE IT. IT SHOULD WORK IN VDMX AND OTHER QUARTZ COMPOSER COMPOSITION HOSTS WITH THE PROVIDED QTZ. IF IT DOES NOT, TELL ME!